home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / mpeg_play-2.1 / README < prev    next >
Text File  |  1995-05-09  |  4KB  |  85 lines
  1.                   MPEG Video Software Decoder
  2.                   (Version 2.1; May 1 1995)
  3.  
  4.  Lawrence A. Rowe, Ketan Patel, Brian Smith, Steve Smoot, and Eugene Hung
  5.       Computer Science Division-EECS, Univ. of Calif. at Berkeley
  6.  
  7. This directory contains a public domain MPEG video software
  8. decoder. The decoder is implemented as a library that will
  9. take a video stream and display it in an X window on an 8, 24
  10. or 32 bit deep display.  The main routine is supplied to
  11. demonstrate the use of the decoder library. Several dithering
  12. algorithms are supplied based on the Floyd-Steinberg, ordered
  13. dither, and half-toning algorithms that tradeoff quality and
  14. performance. Neither the library nor the main routine handle
  15. real-time synchronization or audio streams.
  16.  
  17. The decoder implements the standard described in the Committee 
  18. Draft ISO/IEC CD 11172 dated December 6, 1991 which is
  19. sometimes refered to as "Paris Format." The code has been
  20. compiled and tested on the following platforms:
  21.  
  22.  HP PA-RISC (HP/UX 9.X, X11R5) (i.e., HP 9000/7XX and 9000/3XX)
  23.  Sun Sparc (SunOS 4.X, Solaris)
  24.  DECstation 5000 and Alpha
  25.  Silicon Graphics Indigo
  26.  MIPS RISC/os 4.51
  27.  Linux
  28.  
  29. If you decide to port the code to a new architecture, please let
  30. us know if there are any significant changes, so that we can incorporate
  31. them into our sources. 
  32.  
  33. This directory contains everything required to build and
  34. display video. We have included source code, a makefile, an Imakefile,
  35. installation instructions, and a man page. Data files can
  36. be obtained from the same ftp site this was located in.
  37. See the INSTALL file for instructions on how to
  38. compile and run the decoder. 
  39.  
  40. The data files were produced by XING. XING data does not take
  41. advantage of P or B frames (ie, frames with motion compensation). 
  42. Performance of the player on XING data is significantly slower 
  43. (half or less) than the performance when motion compensated MPEG 
  44. data is decoded. We are very interested in running the software 
  45. on other MPEG streams.  Please contact us if you have a stream 
  46. that does not decode correctly. Also, please send us new streams
  47. produced by others that do utilize P and B frames.
  48.  
  49. Our future plans include porting the decoder to run on other
  50. platforms, integrating it into a video playback system that
  51. supports real-time synchronization and audio streams, and
  52. further experiments to improve the performance of the
  53. decoder. Vendors or other organizations interested in supporting 
  54. this research or discussing other aspects of this project should 
  55. contact Larry Rowe at Rowe@CS.Berkeley.EDU.
  56.  
  57. Reporting bugs:
  58.     If you find any bugs in this software, please send them to
  59.     mpeg-bugs@plateau.cs.berkeley.edu.  Since this software
  60.     is unsupported, we make no guarantees about how long it will
  61.     take to fix the bug, or if it will be fixed at all.  Bug fixes
  62.     will be cheerfully accepted.  Please include as much detailed
  63.     information as possible, including:
  64.  
  65.     1) the version number of the program you are using (cf. VERSION)
  66.     2) the data file that caused the bug (if possible)
  67.     3) the OS version and machine type you ran the program on
  68.     4) the compiler used to compile the program
  69.  
  70. ACKNOWLEDGEMENTS:
  71.     We gratefully thank Hewlett-Packard, Fujitsu, the Semiconductor
  72.     Research Corporation for financial support.
  73.  
  74.     We also want to thank the following people for their help:
  75.  
  76.     Tom Lane of the Independent JPEG Group provided us with
  77.         the basic inverse DCT code used by our player.
  78.         (tom_lane@g.gp.cs.cmu.edu)
  79.  
  80.     Reid Judd of Sun Microsystems provided advice and assistance.
  81.  
  82.     Todd Brunhoff of NVR provided advice and assistance.
  83.  
  84.     Toshihiko Kawai of Sony provided advice and assistance.
  85.